home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / PROGRAMMING / PERL.SPK / Perl5001 / Manual / perldiag_h < prev    next >
Text File  |  1995-04-18  |  76KB  |  2,170 lines

  1. <!-- $RCSfile$$Revision$$Date$ -->
  2. <!-- $Log$ -->
  3. <HTML>
  4. <TITLE> PERLDIAG </TITLE>
  5. <h2>NAME</h2>
  6. perldiag - various Perl diagnostics
  7. <p><h2>DESCRIPTION</h2>
  8. These messages are classified as follows (listed in increasing order of
  9. desperation):
  10. <p><pre>
  11.         (W) A warning (optional).
  12.         (D) A deprecation (optional).
  13.         (S) A severe warning (mandatory).
  14.         (F) A fatal error (trappable).
  15.         (P) An internal error you should never see (trappable).
  16.         (X) A very fatal error (non-trappable).
  17. </pre>
  18. Optional warnings are enabled by using the 
  19. <A HREF="perlrun.html#perlrun_362">-w</A>
  20.  switch.  Trappable
  21. errors may be trapped using the eval operator.  See perlfunc/eval.
  22. <p>Some of these messages are generic.  Spots that vary are denoted with a %s,
  23. just as in a printf format.  Note that some message start with a %s!
  24. The symbols <B>"%-?@</B> sort before the letters, while <B>[</B> and <B>\</B> sort after.
  25. <p>
  26. <dl>
  27. <dt><B>"my" variable %s can't be in a package</B>
  28. <dd>
  29. (F) Lexically scoped variables aren't in a package, so it doesn't make sense
  30. to try to declare one with a package qualifier on the front.  Use local()
  31. if you want to localize a package variable.
  32. <p></dd>
  33. <dt><B>"no" not allowed in expression</B>
  34. <dd>
  35. (F) The "no" keyword is recognized and executed at compile time, and returns
  36. no useful value.  See 
  37. <A HREF="perlmod.html">
  38. the perlmod manpage</A>
  39. .
  40. <p></dd>
  41. <dt><B>"use" not allowed in expression</B>
  42. <dd>
  43. (F) The "use" keyword is recognized and executed at compile time, and returns
  44. no useful value.  See 
  45. <A HREF="perlmod.html">
  46. the perlmod manpage</A>
  47. .
  48. <p></dd>
  49. <dt><B>% may only be used in unpack</B>
  50. <dd>
  51. (F) You can't pack a string by supplying a checksum, since the
  52. checksumming process loses information, and you can't go the other
  53. way.  See perlfunc/unpack.
  54. <p></dd>
  55. <dt><B>%s (...) interpreted as function</B>
  56. <dd>
  57. (W) You've run afoul of the rule that says that any list operator followed
  58. by parentheses turns into a function, with all the list operators arguments 
  59. found inside the parens.  See perlop/Terms and List Operators (Leftward).
  60. <p></dd>
  61. <dt><B>%s argument is not a HASH element</B>
  62. <dd>
  63. (F) The argument to delete() or exists() must be a hash element, such as
  64. <p></dd>
  65. <pre>
  66.         $foo{$bar}
  67.         $ref->[12]->{"susie"}
  68. </pre>
  69. <dt><B>%s did not return a true value</B>
  70. <dd>
  71. (F) A required (or used) file must return a true value to indicate that
  72. it compiled correctly and ran its initialization code correctly.  It's
  73. traditional to end such a file with a "1;", though any true value would
  74. do.  See perlfunc/require.
  75. <p></dd>
  76. <dt><B>%s found where operator expected</B>
  77. <dd>
  78. (S) The Perl lexer knows whether to expect a term or an operator.  If it
  79. sees what it knows to be a term when it was expecting to see an operator,
  80. it gives you this warning.  Usually it indicates that an operator or
  81. delimiter was omitted, such as a semicolon.
  82. <p></dd>
  83. <dt><B>%s had compilation errors.</B>
  84. <dd>
  85. (F) The final summary message when a <B>perl -c</B> fails.
  86. <p></dd>
  87. <dt><B>%s has too many errors.</B>
  88. <dd>
  89. (F) The parser has given up trying to parse the program after 10 errors.
  90. Further error messages would likely be uninformative.
  91. <p></dd>
  92. <dt><B>%s matches null string many times</B>
  93. <dd>
  94. (W) The pattern you've specified would be an infinite loop if the
  95. regular expression engine didn't specifically check for that.  See 
  96. <A HREF="perlre.html">
  97. the perlre manpage</A>
  98. .
  99. <p></dd>
  100. <dt><B>%s never introduced</B>
  101. <dd>
  102. (S) The symbol in question was declared but somehow went out of scope
  103. before it could possibly have been used.
  104. <p></dd>
  105. <dt><B>%s syntax OK</B>
  106. <dd>
  107. (F) The final summary message when a <B>perl -c</B> succeeds.
  108. <p></dd>
  109. <dt><B><A HREF="perlrun.html#perlrun_355">-P</A>  not allowed for setuid/setgid script</B>
  110. <dd>
  111. (F) The script would have to be opened by the C preprocessor by name,
  112. which provides a race condition that breaks security.
  113. <p></dd>
  114. <dt><B><A HREF="perlrun.html#perlrun_358">-T</A>  and <B>-B</B> not implemented on filehandles</B>
  115. <dd>
  116. (F) Perl can't peek at the stdio buffer of filehandles when it doesn't
  117. know about your kind of stdio.  You'll have to use a filename instead.
  118. <p></dd>
  119. <dt><B>?+* follows nothing in regexp</B>
  120. <dd>
  121. (F) You started a regular expression with a quantifier.  Backslash it
  122. if you meant it literally.   See 
  123. <A HREF="perlre.html">
  124. the perlre manpage</A>
  125. .
  126. <p></dd>
  127. <dt><B>@ outside of string</B>
  128. <dd>
  129. (F) You had a pack template that specified an absolution position outside
  130. the string being unpacked.  See perlfunc/pack.
  131. <p></dd>
  132. <dt><B>accept() on closed fd</B>
  133. <dd>
  134. (W) You tried to do an accept on a closed socket.  Did you forget to check
  135. the return value of your socket() call?  See perlfunc/accept.
  136. <p></dd>
  137. <dt><B>Allocation too large: %lx</B>
  138. <dd>
  139. (F) You can't allocate more than 64K on an MSDOS machine.
  140. <p></dd>
  141. <dt><B>Arg too short for msgsnd</B>
  142. <dd>
  143. (F) msgsnd() requires a string at least as long as sizeof(long).
  144. <p></dd>
  145. <dt><B>Args must match #! line</B>
  146. <dd>
  147. (F) The setuid emulator requires that the arguments Perl was invoked
  148. with match the arguments specified on the #! line.
  149. <p></dd>
  150. <dt><B>Argument "%s" isn't numeric</B>
  151. <dd>
  152. (W) The indicated string was fed as an argument to an operator that
  153. expected a numeric value instead.  If you're fortunate the message
  154. will identify which operator was so unfortunate.
  155. <p></dd>
  156. <dt><B>Array @%s missing the @ in argument %d of %s()</B>
  157. <dd>
  158. (D) Really old Perl let you omit the @ on array names in some spots.  This
  159. is now heavily deprecated.
  160. <p></dd>
  161. <dt><B>assertion botched: %s</B>
  162. <dd>
  163. (P) The malloc package that comes with Perl had an internal failure.
  164. <p></dd>
  165. <dt><B>Assertion failed: file "%s"</B>
  166. <dd>
  167. (P) A general assertion failed.  The file in question must be examined.
  168. <p></dd>
  169. <dt><B>Assignment to both a list and a scalar</B>
  170. <dd>
  171. (F) If you assign to a conditional operator, the 2nd and 3rd arguments
  172. must either both be scalars or both be lists.  Otherwise Perl won't
  173. know which context to supply to the right side.
  174. <p></dd>
  175. <dt><B>Attempt to free non-arena SV: 0x%lx</B>
  176. <dd>
  177. (P) All SV objects are supposed to be allocated from arenas that will
  178. be garbage collected on exit.  An SV was discovered to be outside any
  179. of those arenas.
  180. <p></dd>
  181. <dt><B>Attempt to free temp prematurely</B>
  182. <dd>
  183. (W) Mortalized values are supposed to be freed by the free_tmps()
  184. routine.  This indicates that something else is freeing the SV before
  185. the free_tmps() routine gets a chance, which means that the free_tmps()
  186. routine will be freeing an unreferenced scalar when it does try to free
  187. it.
  188. <p></dd>
  189. <dt><B>Attempt to free unreferenced glob pointers</B>
  190. <dd>
  191. (P) The reference counts got screwed up on symbol aliases.
  192. <p></dd>
  193. <dt><B>Attempt to free unreferenced scalar</B>
  194. <dd>
  195. (W) Perl went to decrement the reference count of a scalar to see if it
  196. would go to 0, and discovered that it had already gone to 0 earlier,
  197. and should have been freed, and in fact, probably was freed.  This
  198. could indicate that SvREFCNT_dec() was called too many times, or that
  199. SvREFCNT_inc() was called too few times, or that the SV was mortalized
  200. when it shouldn't have been, or that memory has been corrupted.
  201. <p></dd>
  202. <dt><B>Bad arg length for %s, is %d, should be %d</B>
  203. <dd>
  204. (F) You passed a buffer of the wrong size to one of msgctl(), semctl() or
  205. shmctl().  In C parlance, the correct sized are, respectively,
  206. sizeof(struct msqid_ds *), sizeof(struct semid_ds *) and
  207. sizeof(struct shmid_ds *).
  208. <p></dd>
  209. <dt><B>Bad associative array</B>
  210. <dd>
  211. (P) One of the internal hash routines was passed a null HV pointer.
  212. <p></dd>
  213. <dt><B>Bad filehandle: %s</B>
  214. <dd>
  215. (F) A symbol was passed to something wanting a filehandle, but the symbol
  216. has no filehandle associated with it.  Perhaps you didn't do an open(), or
  217. did it in another package.
  218. <p></dd>
  219. <dt><B>Bad free() ignored</B>
  220. <dd>
  221. (S) An internal routine called free() on something that had never been
  222. malloc()ed in the first place.
  223. <p></dd>
  224. <dt><B>Bad name after %s::</B>
  225. <dd>
  226. (F) You started to name a symbol by using a package prefix, and then didn't
  227. finish the symbol.  In particular, you can't interpolate outside of quotes,
  228. so
  229. <p></dd>
  230. <pre>
  231.         $var = 'myvar';
  232.         $sym = mypack::$var;
  233. </pre>
  234. is not the same as
  235. <p><pre>
  236.         $var = 'myvar';
  237.         $sym = "mypack::$var";
  238. </pre>
  239. <dt><B>Bad symbol for array</B>
  240. <dd>
  241. (P) An internal request asked to add an array entry to something that
  242. wasn't a symbol table entry.
  243. <p></dd>
  244. <dt><B>Bad symbol for filehandle</B>
  245. <dd>
  246. (P) An internal request asked to add a filehandle entry to something that
  247. wasn't a symbol table entry.
  248. <p></dd>
  249. <dt><B>Bad symbol for hash</B>
  250. <dd>
  251. (P) An internal request asked to add a hash entry to something that
  252. wasn't a symbol table entry.
  253. <p></dd>
  254. <dt><B>BEGIN failed--compilation aborted</B>
  255. <dd>
  256. (F) An untrapped exception was raised while executing a BEGIN subroutine.
  257. Compilation stops immediately and the interpreter is exited.
  258. <p></dd>
  259. <dt><B>bind() on closed fd</B>
  260. <dd>
  261. (W) You tried to do a bind on a closed socket.  Did you forget to check
  262. the return value of your socket() call?  See perlfunc/bind.
  263. <p></dd>
  264. <dt><B>Callback called exit</B>
  265. <dd>
  266. (F) A subroutine invoked from an external package via perl_call_sv()
  267. exited by calling exit.
  268. <p></dd>
  269. <dt><B>Can't "last" outside a block</B>
  270. <dd>
  271. (F) A "last" statement was executed to break out of the current block,
  272. except that there's this itty bitty problem called there isn't a
  273. current block.  Note that an "if" or "else" block doesn't count as a
  274. "loopish" block.  You can usually double the curlies to get the same
  275. effect though, since the inner curlies will be considered a block
  276. that loops once.  See perlfunc/last.
  277. <p></dd>
  278. <dt><B>Can't "next" outside a block</B>
  279. <dd>
  280. (F) A "next" statement was executed to reiterate the current block, but
  281. there isn't a current block.  Note that an "if" or "else" block doesn't
  282. count as a "loopish" block.  You can usually double the curlies to get
  283. the same effect though, since the inner curlies will be considered a block
  284. that loops once.  See perlfunc/last.
  285. <p></dd>
  286. <dt><B>Can't "redo" outside a block</B>
  287. <dd>
  288. (F) A "redo" statement was executed to restart the current block, but
  289. there isn't a current block.  Note that an "if" or "else" block doesn't
  290. count as a "loopish" block.  You can usually double the curlies to get
  291. the same effect though, since the inner curlies will be considered a block
  292. that loops once.  See perlfunc/last.
  293. <p></dd>
  294. <dt><B>Can't bless non-reference value</B>
  295. <dd>
  296. (F) Only hard references may be blessed.  This is how Perl "enforces"
  297. encapsulation of objects.  See 
  298. <A HREF="perlobj.html">
  299. the perlobj manpage</A>
  300. .
  301. <p></dd>
  302. <dt><B>Can't break at that line</B>
  303. <dd>
  304. (S) A warning intended for while running within the debugger, indicating
  305. the line number specified wasn't the location of a statement that could
  306. be stopped at.
  307. <p></dd>
  308. <dt><B>Can't call method "%s" in empty package "%s"</B>
  309. <dd>
  310. (F) You called a method correctly, and it correctly indicated a package
  311. functioning as a class, but that package doesn't have ANYTHING defined
  312. in it, let alone methods.  See 
  313. <A HREF="perlobj.html">
  314. the perlobj manpage</A>
  315. .
  316. <p></dd>
  317. <dt><B>Can't call method "%s" on unblessed reference</B>
  318. <dd>
  319. (F) A method call must know what package it's supposed to run in.  It
  320. ordinarily finds this out from the object reference you supply, but
  321. you didn't supply an object reference in this case.  A reference isn't
  322. an object reference until it has been blessed.  See 
  323. <A HREF="perlobj.html">
  324. the perlobj manpage</A>
  325. .
  326. <p></dd>
  327. <dt><B>Can't call method "%s" without a package or object reference</B>
  328. <dd>
  329. (F) You used the syntax of a method call, but the slot filled by the
  330. object reference or package name contains an expression that returns
  331. neither an object reference nor a package name.  (Perhaps it's null?)
  332. Something like this will reproduce the error:
  333. <p></dd>
  334. <pre>
  335.         $BADREF = undef;
  336.         process $BADREF 1,2,3;
  337.         $BADREF->process(1,2,3);
  338. </pre>
  339. <dt><B>Can't chdir to %s</B>
  340. <dd>
  341. (F) You called <B>perl -x/foo/bar</B>, but <B>/foo/bar</B> is not a directory
  342. that you can chdir to, possibly because it doesn't exist.
  343. <p></dd>
  344. <dt><B>Can't coerce %s to integer in %s</B>
  345. <dd>
  346. (F) Certain types of SVs, in particular real symbol table entries
  347. (type GLOB), can't be forced to stop being what they are.  So you can't
  348. say things like:
  349. <p></dd>
  350. <pre>
  351.         *foo += 1;
  352. </pre>
  353. You CAN say
  354. <p><pre>
  355.         $foo = *foo;
  356.         $foo += 1;
  357. </pre>
  358. but then $foo no longer contains a glob.
  359. <p><dt><B>Can't coerce %s to number in %s</B>
  360. <dd>
  361. (F) Certain types of SVs, in particular real symbol table entries
  362. (type GLOB), can't be forced to stop being what they are.
  363. <p></dd>
  364. <dt><B>Can't coerce %s to string in %s</B>
  365. <dd>
  366. (F) Certain types of SVs, in particular real symbol table entries
  367. (type GLOB), can't be forced to stop being what they are.
  368. <p></dd>
  369. <dt><B>Can't create pipe mailbox</B>
  370. <dd>
  371. (F) An error peculiar to VMS.
  372. <p></dd>
  373. <dt><B>Can't declare %s in my</B>
  374. <dd>
  375. (F) Only scalar, array and hash variables may be declared as lexical variables.
  376. They must have ordinary identifiers as names.
  377. <p></dd>
  378. <dt><B>Can't do inplace edit on %s: %s</B>
  379. <dd>
  380. (S) The creation of the new file failed for the indicated reason.
  381. <p></dd>
  382. <dt><B>Can't do inplace edit without backup</B>
  383. <dd>
  384. (F) You're on a system such as MSDOS that gets confused if you try reading
  385. from a deleted (but still opened) file.  You have to say 
  386. <A HREF="perlrun.html#perlrun_350">-i</A>
  387. <B>.bak</B>, or some
  388. such.
  389. <p></dd>
  390. <dt><B>Can't do inplace edit: %s > 14 characters</B>
  391. <dd>
  392. (S) There isn't enough room in the filename to make a backup name for the file.
  393. <p></dd>
  394. <dt><B>Can't do inplace edit: %s is not a regular file</B>
  395. <dd>
  396. (S) You tried to use the 
  397. <A HREF="perlrun.html#perlrun_350">-i</A>
  398.  switch on a special file, such as a file in
  399. /dev, or a FIFO.  The file was ignored.
  400. <p></dd>
  401. <dt><B>Can't do setegid!</B>
  402. <dd>
  403. (P) The setegid() call failed for some reason in the setuid emulator
  404. of suidperl.
  405. <p></dd>
  406. <dt><B>Can't do seteuid!</B>
  407. <dd>
  408. (P) The setuid emulator of suidperl failed for some reason.
  409. <p></dd>
  410. <dt><B>Can't do setuid</B>
  411. <dd>
  412. (F) This typically means that ordinary perl tried to exec suidperl to
  413. do setuid emulation, but couldn't exec it.  It looks for a name of the
  414. form sperl5.000 in the same directory that the perl executable resides
  415. under the name perl5.000, typically /usr/local/bin on Unix machines.
  416. If the file is there, check the execute permissions.  If it isn't, ask
  417. your sysadmin why he and/or she removed it.
  418. <p></dd>
  419. <dt><B>Can't do waitpid with flags</B>
  420. <dd>
  421. (F) This machine doesn't have either waitpid() or wait4(), so only waitpid()
  422. without flags is emulated.
  423. <p></dd>
  424. <dt><B>Can't do {n,m} with n > m</B>
  425. <dd>
  426. (F) Minima must be less than or equal to maxima.  If you really want
  427. your regexp to match something 0 times, just put {0}.  See 
  428. <A HREF="perlre.html">
  429. the perlre manpage</A>
  430. .
  431. <p></dd>
  432. <dt><B>Can't emulate -%s on #! line</B>
  433. <dd>
  434. (F) The #! line specifies a switch that doesn't make sense at this point.
  435. For example, it'd be kind of silly to put a 
  436. <A HREF="perlrun.html#perlrun_363">-x</A>
  437.  on the #! line.
  438. <p></dd>
  439. <dt><B>Can't exec "%s": %s</B>
  440. <dd>
  441. (W) An system(), exec() or piped open call could not execute the named
  442. program for the indicated reason.  Typical reasons include: the permissions
  443. were wrong on the file, the file wasn't found in <B>$ENV{PATH}</B>, the
  444. executable in question was compiled for another architecture, or the
  445. #! line in a script points to an interpreter that can't be run for
  446. similar reasons.  (Or maybe your system doesn't support #! at all.)
  447. <p></dd>
  448. <dt><B>Can't exec %s</B>
  449. <dd>
  450. (F) Perl was trying to execute the indicated program for you because that's
  451. what the #! line said.  If that's not what you wanted, you may need to
  452. mention "perl" on the #! line somewhere.
  453. <p></dd>
  454. <dt><B>Can't execute %s</B>
  455. <dd>
  456. (F) You used the 
  457. <A HREF="perlrun.html#perlrun_357">-S</A>
  458.  switch, but the script to execute could not be found
  459. in the PATH, or at least not with the correct permissions.
  460. <p></dd>
  461. <dt><B>Can't find label %s</B>
  462. <dd>
  463. (F) You said to goto a label that isn't mentioned anywhere that it's possible
  464. for us to go to.  See perlfunc/goto.
  465. <p></dd>
  466. <dt><B>Can't find string terminator %s anywhere before EOF</B>
  467. <dd>
  468. (F) Perl strings can stretch over multiple lines.  This message means that
  469. the closing delimiter was omitted.  Since bracketed quotes count nesting
  470. levels, the following is missing its final parenthesis:
  471. <p></dd>
  472. <pre>
  473.         print q(The character '(' starts a side comment.)
  474. </pre>
  475. <dt><B>Can't fork</B>
  476. <dd>
  477. (F) A fatal error occurred while trying to fork while opening a pipeline.
  478. <p></dd>
  479. <dt><B>Can't get pipe mailbox device name</B>
  480. <dd>
  481. (F) An error peculiar to VMS.
  482. <p></dd>
  483. <dt><B>Can't get SYSGEN parameter value for MAXBUF</B>
  484. <dd>
  485. (F) An error peculiar to VMS.
  486. <p></dd>
  487. <dt><B>Can't goto subroutine outside a subroutine</B>
  488. <dd>
  489. (F) The deeply magical "goto subroutine" call can only replace one subroutine
  490. call for another.  It can't manufacture one out of whole cloth.  In general
  491. you should only be calling it out of an AUTOLOAD routine anyway.  See
  492. perlfunc/goto.
  493. <p></dd>
  494. <dt><B>Can't locate %s in @INC</B>
  495. <dd>
  496. (F) You said to do (or require, or use) a file that couldn't be found
  497. in any of the libraries mentioned in @INC.  Perhaps you need to set
  498. the PERL5LIB environment variable to say where the extra library is,
  499. or maybe the script needs to add the library name to @INC.  Or maybe
  500. you just misspelled the name of the file.  See perlfunc/require.
  501. <p></dd>
  502. <dt><B>Can't locate object method "%s" via package "%s"</B>
  503. <dd>
  504. (F) You called a method correctly, and it correctly indicated a package
  505. functioning as a class, but that package doesn't define that particular
  506. method, nor does any of it's base classes.  See 
  507. <A HREF="perlobj.html">
  508. the perlobj manpage</A>
  509. .
  510. <p></dd>
  511. <dt><B>Can't locate package %s for @%s::ISA</B>
  512. <dd>
  513. (W) The @ISA array contained the name of another package that doesn't seem
  514. to exist.
  515. <p></dd>
  516. <dt><B>Can't mktemp()</B>
  517. <dd>
  518. (F) The mktemp() routine failed for some reason while trying to process
  519. <A HREF="perlrun.html#perlrun_348">-e</A>
  520.  switch.  Maybe your /tmp partition is full, or clobbered.
  521. <p></dd>
  522. <dt><B>Can't modify %s in %s</B>
  523. <dd>
  524. (F) You aren't allowed to assign to the item indicated, or otherwise try to
  525. change it, such as with an autoincrement.
  526. <p></dd>
  527. <dt><B>Can't modify non-existent substring</B>
  528. <dd>
  529. (P) The internal routine that does assignment to a substr() was handed
  530. a NULL.
  531. <p></dd>
  532. <dt><B>Can't msgrcv to readonly var</B>
  533. <dd>
  534. (F) The target of a msgrcv must be modifiable in order to be used as a receive
  535. buffer.
  536. <p></dd>
  537. <dt><B>Can't open %s: %s</B>
  538. <dd>
  539. (S) An inplace edit couldn't open the original file for the indicated reason.
  540. Usually this is because you don't have read permission for the file.
  541. <p></dd>
  542. <dt><B>Can't open bidirectional pipe</B>
  543. <dd>
  544. (W) You tried to say <B>open(CMD, "|cmd|")</B>, which is not supported.  You can
  545. try any of several modules in the Perl library to do this, such as
  546. "open2.pl".  Alternately, direct the pipe's output to a file using ">",
  547. and then read it in under a different file handle.
  548. <p></dd>
  549. <dt><B>Can't open perl script "%s": %s</B>
  550. <dd>
  551. (F) The script you specified can't be opened for the indicated reason.
  552. <p></dd>
  553. <dt><B>Can't rename %s to %s: %s, skipping file</B>
  554. <dd>
  555. (S) The rename done by the 
  556. <A HREF="perlrun.html#perlrun_350">-i</A>
  557.  switch failed for some reason, probably because
  558. you don't have write permission to the directory.
  559. <p></dd>
  560. <dt><B>Can't reswap uid and euid</B>
  561. <dd>
  562. (P) The setreuid() call failed for some reason in the setuid emulator
  563. of suidperl.
  564. <p></dd>
  565. <dt><B>Can't return outside a subroutine</B>
  566. <dd>
  567. (F) The return statement was executed in mainline code, that is, where
  568. there was no subroutine call to return out of.  See 
  569. <A HREF="perlsub.html">
  570. the perlsub manpage</A>
  571. .
  572. <p></dd>
  573. <dt><B>Can't stat script "%s"</B>
  574. <dd>
  575. (P) For some reason you can't fstat() the script even though you have
  576. it open already.  Bizarre.
  577. <p></dd>
  578. <dt><B>Can't swap uid and euid</B>
  579. <dd>
  580. (P) The setreuid() call failed for some reason in the setuid emulator
  581. of suidperl.
  582. <p></dd>
  583. <dt><B>Can't take log of %g</B>
  584. <dd>
  585. (F) Logarithms are only defined on positive real numbers.
  586. <p></dd>
  587. <dt><B>Can't take sqrt of %g</B>
  588. <dd>
  589. (F) For ordinary real numbers, you can't take the square root of a
  590. negative number.  There's a Complex package available for Perl, though,
  591. if you really want to do that.
  592. <p></dd>
  593. <dt><B>Can't undef active subroutine</B>
  594. <dd>
  595. (F) You can't undefine a routine that's currently running.  You can,
  596. however, redefine it while it's running, and you can even undef the
  597. redefined subroutine while the old routine is running.  Go figure.
  598. <p></dd>
  599. <dt><B>Can't unshift</B>
  600. <dd>
  601. (F) You tried to unshift an "unreal" array that can't be unshifted, such
  602. as the main Perl stack.
  603. <p></dd>
  604. <dt><B>Can't upgrade that kind of scalar</B>
  605. <dd>
  606. (P) The internal sv_upgrade routine adds "members" to an SV, making
  607. it into a more specialized kind of SV.  The top several SV types are
  608. so specialized, however, that they cannot be interconverted.  This
  609. message indicates that such a conversion was attempted.
  610. <p></dd>
  611. <dt><B>Can't upgrade to undef</B>
  612. <dd>
  613. (P) The undefined SV is the bottom of the totem pole, in the scheme
  614. of upgradability.  Upgrading to undef indicates an error in the
  615. code calling sv_upgrade.
  616. <p></dd>
  617. <dt><B>Can't use %s as left arg of an implicit -></B>
  618. <dd>
  619. (F) The compiler tried to interpret a bracketed expression as a subscript
  620. to an array reference.  But to the left of the brackets was an expression
  621. that didn't end in an arrow (->), or look like a subscripted expression.
  622. Only subscripted expressions with multiple subscripts are allowed to omit 
  623. the intervening arrow.
  624. <p></dd>
  625. <dt><B>Can't use %s for loop variable</B>
  626. <dd>
  627. (F) Only a simple scalar variable may be used as a loop variable on a foreach.
  628. <p></dd>
  629. <dt><B>Can't use %s ref as %s ref</B>
  630. <dd>
  631. (F) You've mixed up your reference types.  You have to dereference a
  632. reference of the type needed.  You can use the ref() function to
  633. test the type of the reference, if need be.
  634. <p></dd>
  635. <dt><B>Can't use a string as %s ref while "strict refs" in use</B>
  636. <dd>
  637. (F) Only hard references are allowed by "strict refs".  Symbolic references
  638. are disallowed.  See 
  639. <A HREF="perlref.html">
  640. the perlref manpage</A>
  641. .
  642. <p></dd>
  643. <dt><B>Can't use an undefined value as %s reference</B>
  644. <dd>
  645. (F) A value used as either a hard reference or a symbolic reference must
  646. be a defined value.  This helps to de-lurk some insidious errors.
  647. <p></dd>
  648. <dt><B>Can't use delimiter brackets within expression</B>
  649. <dd>
  650. (F) The ${name} construct is for disambiguating identifiers in strings, not
  651. in ordinary code.
  652. <p></dd>
  653. <dt><B>Can't use global %s in "my"</B>
  654. <dd>
  655. (F) You tried to declare a magical variable as a lexical variable.  This is
  656. not allowed, because the magic can only be tied to one location (namely
  657. the global variable) and it would be incredibly confusing to have
  658. variables in your program that looked like magical variables but
  659. weren't.
  660. <p></dd>
  661. <dt><B>Can't write to temp file for  <A HREF="perlrun.html#perlrun_348">-e</A> : %s</B>
  662. <dd>
  663. (F) The write routine failed for some reason while trying to process
  664. <A HREF="perlrun.html#perlrun_348">-e</A>
  665.  switch.  Maybe your /tmp partition is full, or clobbered.
  666. <p></dd>
  667. <dt><B>Can't x= to readonly value</B>
  668. <dd>
  669. (F) You tried to repeat a constant value (often the undefined value) with
  670. an assignment operator, which implies modifying the value itself.
  671. Perhaps you need to copy the value to a temporary, and repeat that.
  672. <p></dd>
  673. <dt><B>Cannot open temporary file</B>
  674. <dd>
  675. (F) The create routine failed for some reaon while trying to process
  676. <A HREF="perlrun.html#perlrun_348">-e</A>
  677.  switch.  Maybe your /tmp partition is full, or clobbered.
  678. <p></dd>
  679. <dt><B>chmod: mode argument is missing initial 0</B>
  680. <dd>
  681. (W) A novice will sometimes say
  682. <p></dd>
  683. <pre>
  684.         chmod 777, $filename
  685. </pre>
  686. not realizing that 777 will be interpreted as a decimal number, equivalent
  687. to 01411.  Octal constants are introduced with a leading 0 in Perl, as in C.
  688. <p><dt><B>Close on unopened file <%s></B>
  689. <dd>
  690. (W) You tried to close a filehandle that was never opened.
  691. <p></dd>
  692. <dt><B>connect() on closed fd</B>
  693. <dd>
  694. (W) You tried to do a connect on a closed socket.  Did you forget to check
  695. the return value of your socket() call?  See perlfunc/connect.
  696. <p></dd>
  697. <dt><B>Corrupt malloc ptr 0x%lx at 0x%lx</B>
  698. <dd>
  699. (P) The malloc package that comes with Perl had an internal failure.
  700. <p></dd>
  701. <dt><B>corrupted regexp pointers</B>
  702. <dd>
  703. (P) The regular expression engine got confused by what the regular
  704. expression compiler gave it.
  705. <p></dd>
  706. <dt><B>corrupted regexp program</B>
  707. <dd>
  708. (P) The regular expression engine got passed a regexp program without
  709. a valid magic number.
  710. <p></dd>
  711. <dt><B>Deep recursion on subroutine "%s"</B>
  712. <dd>
  713. (W) This subroutine has called itself (directly or indirectly) 100
  714. times than it has returned.  This probably indicates an infinite
  715. recursion, unless you're writing strange benchmark programs, in which
  716. case it indicates something else.
  717. <p></dd>
  718. <dt><B>Did you mean $ instead of %?</B>
  719. <dd>
  720. (W) You probably said %hash{$key} when you meant $hash{$key}.
  721. <p></dd>
  722. <dt><B>Don't know how to handle magic of type '%s'</B>
  723. <dd>
  724. (P) The internal handling of magical variables has been cursed.
  725. <p></dd>
  726. <dt><B>do_study: out of memory</B>
  727. <dd>
  728. (P) This should have been caught by safemalloc() instead.
  729. <p></dd>
  730. <dt><B>Duplicate free() ignored</B>
  731. <dd>
  732. (S) An internal routine called free() on something that had already
  733. been freed.
  734. <p></dd>
  735. <dt><B>END failed--cleanup aborted</B>
  736. <dd>
  737. (F) An untrapped exception was raised while executing an END subroutine.
  738. The interpreter is immediately exited.
  739. <p></dd>
  740. <dt><B>Execution of %s aborted due to compilation errors.</B>
  741. <dd>
  742. (F) The final summary message when a Perl compilation fails.
  743. <p></dd>
  744. <dt><B>Exiting eval via %s</B>
  745. <dd>
  746. (W) You are exiting an eval by unconventional means, such as a
  747. a goto, or a loop control statement.
  748. <p></dd>
  749. <dt><B>Exiting subroutine via %s</B>
  750. <dd>
  751. (W) You are exiting a subroutine by unconventional means, such as a
  752. a goto, or a loop control statement.
  753. <p></dd>
  754. <dt><B>Exiting substitution via %s</B>
  755. <dd>
  756. (W) You are exiting a substitution by unconventional means, such as a
  757. a return, a goto, or a loop control statement.
  758. <p></dd>
  759. <dt><B>Fatal $PUTMSG error: %d</B>
  760. <dd>
  761. (F) An error peculiar to VMS.
  762. <p></dd>
  763.  
  764. <dt><b><A NAME="perlfunc_106">fcntl is not implemented</A></b>
  765. <dd>
  766. (F) Your machine apparently doesn't implement fcntl().  What is this, a
  767. PDP-11 or something?
  768. <p></dd>
  769. <dt><B>Filehandle %s never opened</B>
  770. <dd>
  771. (W) An I/O operation was attempted on a filehandle that was never initialized.
  772. You need to do an open() or a socket() call, or call a constructor from
  773. the FileHandle package.
  774. <p></dd>
  775. <dt><B>Filehandle %s opened only for input</B>
  776. <dd>
  777. (W) You tried to write on a read-only filehandle.  If you
  778. intended it to be a read-write filehandle, you needed to open it with
  779. "+<" or "+>" or ">>" instead of with "<" or nothing.  If you only
  780. intended to write the file, use ">" or >>".  See perlfunc/open.
  781. <p></dd>
  782. <dt><B>Filehandle only opened for input</B>
  783. <dd>
  784. (W) You tried to write on a read-only filehandle.  If you
  785. intended it to be a read-write filehandle, you needed to open it with
  786. "+<" or "+>" or ">>" instead of with "<" or nothing.  If you only
  787. intended to write the file, use ">" or >>".  See perlfunc/open.
  788. <p></dd>
  789. <dt><B>Final $ should be \$ or $name</B>
  790. <dd>
  791. (F) You must now decide whether the final $ in a string was meant to be
  792. a literal dollar sign, or was meant to introduce a variable name
  793. that happens to be missing.  So you have to put either the backslash or
  794. the name.
  795. <p></dd>
  796. <dt><B>Final @ should be \@ or @name</B>
  797. <dd>
  798. (F) You must now decide whether the final @ in a string was meant to be
  799. a literal "at" sign, or was meant to introduce a variable name
  800. that happens to be missing.  So you have to put either the backslash or
  801. the name.
  802. <p></dd>
  803. <dt><B>Format %s redefined</B>
  804. <dd>
  805. (W) You redefined a format.  To suppress this warning, say
  806. <p></dd>
  807. <pre>
  808.         {
  809.         local $^W = 0;
  810.         eval "format NAME =...";
  811.         }
  812. </pre>
  813. <dt><B>Format not terminated</B>
  814. <dd>
  815. (F) A format must be terminated by a line with a solitary dot.  Perl got
  816. to the end of your file without finding such a line.
  817. <p></dd>
  818. <dt><B>Found = in conditional, should be ==</B>
  819. <dd>
  820. (W) You said
  821. <p></dd>
  822. <pre>
  823.         if ($foo = 123)
  824. </pre>
  825. when you meant
  826. <p><pre>
  827.         if ($foo == 123)
  828. </pre>
  829. (or something like that).
  830. <p><dt><B>gdbm store returned %d, errno %d, key "%s"</B>
  831. <dd>
  832. (S) A warning from the GDBM_File extension that a store failed.
  833. <p></dd>
  834.  
  835. <dt><b><A NAME="perlfunc_131">gethostent not implemented</A></b>
  836. <dd>
  837. (F) Your C library apparently doesn't implement gethostent(), probably
  838. because if it did, it'd feel morally obligated to return every hostname
  839. on the Internet.
  840. <p></dd>
  841. <dt><B>get{sock,peer}name() on closed fd</B>
  842. <dd>
  843. (W) You tried to get a socket or peer socket name on a closed socket.
  844. Did you forget to check the return value of your socket() call?
  845. <p></dd>
  846. <dt><B>Glob not terminated</B>
  847. <dd>
  848. (F) The lexer saw a left angle bracket in a place where it was expecting
  849. a term, so it's looking for the corresponding right angle bracket, and not
  850. finding it.  Chances are you left some needed parentheses out earlier in
  851. the line, and you really meant a "less than".
  852. <p></dd>
  853. <dt><B>Global symbol "%s" requires explicit package name</B>
  854. <dd>
  855. (F) You've said "use strict vars", which indicates that all variables must
  856. either be lexically scoped (using "my"), or explicitly qualified to
  857. say which package the global variable is in (using "::").
  858. <p></dd>
  859.  
  860. <dt><b><A NAME="perlfunc_151">goto must have label</A></b>
  861. <dd>
  862. (F) Unlike with "next" or "last", you're not allowed to goto an
  863. unspecified destination.  See perlfunc/goto.
  864. <p></dd>
  865. <dt><B>Had to create %s unexpectedly</B>
  866. <dd>
  867. (S) A routine asked for a symbol from a symbol table that ought to have
  868. existed already, but for some reason it didn't, and had to be created on
  869. an emergency basis to prevent a core dump.
  870. <p></dd>
  871. <dt><B>Hash %%s missing the % in argument %d of %s()</B>
  872. <dd>
  873. (D) Really old Perl let you omit the % on hash names in some spots.  This
  874. is now heavily deprecated.
  875. <p></dd>
  876. <dt><B>Identifier "%s::%s" used only once: possible typo</B>
  877. <dd>
  878. (W) Typographical errors often show up as unique identifiers.  If you
  879. had a good reason for having a unique identifier, then just mention it
  880. again somehow to suppress the message.
  881. <p></dd>
  882. <dt><B>Illegal division by zero</B>
  883. <dd>
  884. (F) You tried to divide a number by 0.  Either something was wrong in your
  885. logic, or you need to put a conditional in to guard against meaningless input.
  886. <p></dd>
  887. <dt><B>Illegal modulus zero</B>
  888. <dd>
  889. (F) You tried to divide a number by 0 to get the remainder.  Most numbers
  890. don't take to this kindly.
  891. <p></dd>
  892. <dt><B>Illegal octal digit</B>
  893. <dd>
  894. (F) You used an 8 or 9 in a octal number.
  895. <p></dd>
  896. <dt><B>Insecure dependency in %s</B>
  897. <dd>
  898. (F) You tried to do something that the tainting mechanism didn't like. 
  899. The tainting mechanism is turned on when you're running setuid or setgid,
  900. or when you specify 
  901. <A HREF="perlrun.html#perlrun_358">-T</A>
  902.  to turn it on explicitly.  The tainting mechanism
  903. labels all data that's derived directly or indirectly from the user,
  904. who is considered to be unworthy of your trust.  If any such data is
  905. used in a "dangerous" operation, you get this error.  See 
  906. <A HREF="perlsec.html">
  907. the perlsec manpage</A>
  908.  
  909. for more information.
  910. <p></dd>
  911. <dt><B>Insecure directory in %s</B>
  912. <dd>
  913. (F) You can't use system(), exec(), or a piped open in a setuid or setgid
  914. script if $ENV{PATH} contains a directory that is writable by the world.
  915. See 
  916. <A HREF="perlsec.html">
  917. the perlsec manpage</A>
  918. .
  919. <p></dd>
  920. <dt><B>Insecure PATH</B>
  921. <dd>
  922. (F) You can't use system(), exec(), or a piped open in a setuid or
  923. setgid script if $ENV{PATH} is derived from data supplied (or
  924. potentially supplied) by the user.  The script must set the path to a
  925. known value, using trustworthy data.  See 
  926. <A HREF="perlsec.html">
  927. the perlsec manpage</A>
  928. .
  929. <p></dd>
  930. <dt><B>internal disaster in regexp</B>
  931. <dd>
  932. (P) Something went badly wrong in the regular expression parser.
  933. <p></dd>
  934. <dt><B>internal urp in regexp at /%s/</B>
  935. <dd>
  936. (P) Something went badly awry in the regular expression parser.
  937. <p></dd>
  938. <dt><B>invalid [] range in regexp</B>
  939. <dd>
  940. (F) The range specified in a character class had a minimum character
  941. greater than the maximum character.  See 
  942. <A HREF="perlre.html">
  943. the perlre manpage</A>
  944. .
  945. <p></dd>
  946.  
  947. <dt><b><A NAME="perlfunc_157">ioctl is not implemented</A></b>
  948. <dd>
  949. (F) Your machine apparently doesn't implement ioctl(), which is pretty
  950. strange for a machine that supports C.
  951. <p></dd>
  952. <dt><B>junk on end of regexp</B>
  953. <dd>
  954. (P) The regular expression parser is confused.
  955. <p></dd>
  956. <dt><B>Label not found for "last %s"</B>
  957. <dd>
  958. (F) You named a loop to break out of, but you're not currently in a
  959. loop of that name, not even if you count where you were called from.
  960. See perlfunc/last.
  961. <p></dd>
  962. <dt><B>Label not found for "next %s"</B>
  963. <dd>
  964. (F) You named a loop to continue, but you're not currently in a loop of
  965. that name, not even if you count where you were called from.  See
  966. perlfunc/last.
  967. <p></dd>
  968. <dt><B>Label not found for "redo %s"</B>
  969. <dd>
  970. (F) You named a loop to restart, but you're not currently in a loop of
  971. that name, not even if you count where you were called from.  See
  972. perlfunc/last.
  973. <p></dd>
  974. <dt><B>listen() on closed fd</B>
  975. <dd>
  976. (W) You tried to do a listen on a closed socket.  Did you forget to check
  977. the return value of your socket() call?  See perlfunc/listen.
  978. <p></dd>
  979. <dt><B>Literal @%s now requires backslash</B>
  980. <dd>
  981. (F) It used to be that Perl would try to guess whether you wanted an
  982. array interpolated or a literal @.  It did this when the string was
  983. first used at runtime.  Now strings are parsed at compile time, and
  984. ambiguous instances of @ must be disambiguated, either by putting a
  985. backslash to indicate a literal, or by declaring (or using) the array
  986. within the program before the string (lexically).  (Someday it will simply
  987. assume that an unbackslashed @ interpolates an array.)
  988. <p></dd>
  989. <dt><B>Method for operation %s not found in package %s during blessing</B>
  990. <dd>
  991. (F) An attempt was made to specify an entry in an overloading table that
  992. doesn't somehow point to a valid method.  See 
  993. <A HREF="perlovl.html">
  994. the perlovl manpage</A>
  995. .
  996. <p></dd>
  997. <dt><B>Might be a runaway multi-line %s string starting on line %d</B>
  998. <dd>
  999. (S) An advisory indicating that the previous error may have been caused
  1000. by a missing delimiter on a string or pattern, because it eventually
  1001. ended earlier on the current line.
  1002. <p></dd>
  1003. <dt><B>Misplaced _ in number</B>
  1004. <dd>
  1005. (W) An underline in a decimal constant wasn't on a 3-digit boundary.
  1006. <p></dd>
  1007. <dt><B>Missing $ on loop variable</B>
  1008. <dd>
  1009. (F) Apparently you've been programming in csh too much.  Variables are always
  1010. mentioned with the $ in Perl, unlike in the shells, where it can vary from 
  1011. one line to the next.
  1012. <p></dd>
  1013. <dt><B>Missing comma after first argument to %s function</B>
  1014. <dd>
  1015. (F) While certain functions allow you to specify a filehandle or an
  1016. "indirect object" before the argument list, this ain't one of them.
  1017. <p></dd>
  1018. <dt><B>Missing right bracket</B>
  1019. <dd>
  1020. (F) The lexer counted more opening curly brackets (braces) than closing ones.
  1021. As a general rule, you'll find it's missing near the place you were last
  1022. editing.
  1023. <p></dd>
  1024. <dt><B>Missing semicolon on previous line?</B>
  1025. <dd>
  1026. (S) This is an educated guess made in conjunction with the message "%s
  1027. found where operator expected".  Don't automatically put a semicolon on
  1028. the previous line just because you saw this message.
  1029. <p></dd>
  1030. <dt><B>Modification of a read-only value attempted</B>
  1031. <dd>
  1032. (F) You tried, directly or indirectly, to change the value of a
  1033. constant.  You didn't, of course, try "2 = 1", since the compiler
  1034. catches that.  But an easy way to do the same thing is:
  1035. <p></dd>
  1036. <pre>
  1037.         sub mod { $_[0] = 1 }
  1038.         mod(2);
  1039. </pre>
  1040. Another way is to assign to a substr() that's off the end of the string.
  1041. <p><dt><B>Modification of non-creatable array value attempted, subscript %d</B>
  1042. <dd>
  1043. (F) You tried to make an array value spring into existence, and the
  1044. subscript was probably negative, even counting from end of the array
  1045. backwards.
  1046. <p></dd>
  1047. <dt><B>Modification of non-creatable hash value attempted, subscript "%s"</B>
  1048. <dd>
  1049. (F) You tried to make a hash value spring into existence, and it couldn't
  1050. be created for some peculiar reason.
  1051. <p></dd>
  1052. <dt><B>Module name must be constant</B>
  1053. <dd>
  1054. (F) Only a bare module name is allowed as the first argument to a "use".
  1055. <p></dd>
  1056. <dt><B>msg%s not implemented</B>
  1057. <dd>
  1058. (F) You don't have System V message IPC on your system.
  1059. <p></dd>
  1060. <dt><B>Multidimensional syntax %s not supported</B>
  1061. <dd>
  1062. (W) Multidimensional arrays aren't written like $foo[1,2,3].  They're written
  1063. like $foo[1][2][3], as in C.
  1064. <p></dd>
  1065. <dt><B>Negative length</B>
  1066. <dd>
  1067. (F) You tried to do a read/write/send/recv operation with a buffer length
  1068. that is less than 0.  This is difficult to imagine.
  1069. <p></dd>
  1070. <dt><B>nested *?+ in regexp</B>
  1071. <dd>
  1072. (F) You can't quantify a quantifier without intervening parens.  So
  1073. things like ** or +* or ?* are illegal.
  1074. <p></dd>
  1075. Note, however, that the minimal matching quantifiers, *?, +? and ?? appear
  1076. to be nested quantifiers, but aren't.  See 
  1077. <A HREF="perlre.html">
  1078. the perlre manpage</A>
  1079. .
  1080. <p><dt><B>No #! line</B>
  1081. <dd>
  1082. (F) The setuid emulator requires that scripts have a well-formed #! line
  1083. even on machines that don't support the #! construct.
  1084. <p></dd>
  1085. <dt><B>No %s allowed while running setuid</B>
  1086. <dd>
  1087. (F) Certain operations are deemed to be too insecure for a setuid or setgid
  1088. script to even be allowed to attempt.  Generally speaking there will be
  1089. another way to do what you want that is, if not secure, at least securable.
  1090. See 
  1091. <A HREF="perlsec.html">
  1092. the perlsec manpage</A>
  1093. .
  1094. <p></dd>
  1095. <dt><B>No  <A HREF="perlrun.html#perlrun_348">-e</A>  allowed in setuid scripts</B>
  1096. <dd>
  1097. (F) A setuid script can't be specified by the user.
  1098. <p></dd>
  1099. <dt><B>No comma allowed after %s</B>
  1100. <dd>
  1101. (F) A list operator that has a filehandle or "indirect object" is not
  1102. allowed to have a comma between that and the following arguments.
  1103. Otherwise it'd be just another one of the arguments.
  1104. <p></dd>
  1105. <dt><B>No DB::DB routine defined</B>
  1106. <dd>
  1107. (F) The currently executing code was compiled with the 
  1108. <A HREF="perlrun.html#perlrun_346">-d</A>
  1109.  switch,
  1110. but for some reason the perl5db.pl file (or some facsimile thereof)
  1111. didn't define a routine to be called at the beginning of each
  1112. statement.  Which is odd, because the file should have been required
  1113. automatically, and should have blown up the require if it didn't parse
  1114. right.
  1115. <p></dd>
  1116. <dt><B>No dbm on this machine</B>
  1117. <dd>
  1118. (P) This is counted as an internal error, because every machine should
  1119. supply dbm nowadays, since Perl comes with SDBM.  See SDBM_File.
  1120. <p></dd>
  1121. <dt><B>No DBsub routine</B>
  1122. <dd>
  1123. (F) The currently executing code was compiled with the 
  1124. <A HREF="perlrun.html#perlrun_346">-d</A>
  1125.  switch,
  1126. but for some reason the perl5db.pl file (or some facsimile thereof)
  1127. didn't define a DB::sub routine to be called at the beginning of each
  1128. ordinary subroutine call.
  1129. <p></dd>
  1130. <dt><B>No Perl script found in input</B>
  1131. <dd>
  1132. (F) You called <B>perl -x</B>, but no line was found in the file beginning
  1133. with #! and containing the word "perl".
  1134. <p></dd>
  1135. <dt><B>No setregid available</B>
  1136. <dd>
  1137. (F) Configure didn't find anything resembling the setregid() call for
  1138. your system.
  1139. <p></dd>
  1140. <dt><B>No setreuid available</B>
  1141. <dd>
  1142. (F) Configure didn't find anything resembling the setreuid() call for
  1143. your system.
  1144. <p></dd>
  1145. <dt><B>No space allowed after  <A HREF="perlrun.html#perlrun_351">-I</A> </B>
  1146. <dd>
  1147. (F) The argument to 
  1148. <A HREF="perlrun.html#perlrun_351">-I</A>
  1149.  must follow the 
  1150. <A HREF="perlrun.html#perlrun_351">-I</A>
  1151.  immediately with no
  1152. intervening space.
  1153. <p></dd>
  1154. <dt><B>No such signal: SIG%s</B>
  1155. <dd>
  1156. (W) You specified a signal name as a subscript to %SIG that was not recognized.
  1157. Say <B>kill -l</B> in your shell to see the valid signal names on your system.
  1158. <p></dd>
  1159. <dt><B>Not a CODE reference</B>
  1160. <dd>
  1161. (F) Perl was trying to evaluate a reference to a code value (that is, a
  1162. subroutine), but found a reference to something else instead.  You can
  1163. use the ref() function to find out what kind of ref it really was.
  1164. See also 
  1165. <A HREF="perlref.html">
  1166. the perlref manpage</A>
  1167. .
  1168. <p></dd>
  1169. <dt><B>Not a format reference</B>
  1170. <dd>
  1171. (F) I'm not sure how you managed to generate a reference to an anonymous
  1172. format, but this indicates you did, and that it didn't exist.
  1173. <p></dd>
  1174. <dt><B>Not a GLOB reference</B>
  1175. <dd>
  1176. (F) Perl was trying to evaluate a reference to a "type glob" (that is,
  1177. a symbol table entry that looks like <B>*foo</B>), but found a reference to
  1178. something else instead.  You can use the ref() function to find out
  1179. what kind of ref it really was.  See 
  1180. <A HREF="perlref.html">
  1181. the perlref manpage</A>
  1182. .
  1183. <p></dd>
  1184. <dt><B>Not a HASH reference</B>
  1185. <dd>
  1186. (F) Perl was trying to evaluate a reference to a hash value, but
  1187. found a reference to something else instead.  You can use the ref()
  1188. function to find out what kind of ref it really was.  See 
  1189. <A HREF="perlref.html">
  1190. the perlref manpage</A>
  1191. .
  1192. <p></dd>
  1193. <dt><B>Not a perl script</B>
  1194. <dd>
  1195. (F) The setuid emulator requires that scripts have a well-formed #! line
  1196. even on machines that don't support the #! construct.  The line must
  1197. mention perl.
  1198. <p></dd>
  1199. <dt><B>Not a SCALAR reference</B>
  1200. <dd>
  1201. (F) Perl was trying to evaluate a reference to a scalar value, but
  1202. found a reference to something else instead.  You can use the ref()
  1203. function to find out what kind of ref it really was.  See 
  1204. <A HREF="perlref.html">
  1205. the perlref manpage</A>
  1206. .
  1207. <p></dd>
  1208. <dt><B>Not a subroutine reference</B>
  1209. <dd>
  1210. (F) Perl was trying to evaluate a reference to a code value (that is, a
  1211. subroutine), but found a reference to something else instead.  You can
  1212. use the ref() function to find out what kind of ref it really was.
  1213. See also 
  1214. <A HREF="perlref.html">
  1215. the perlref manpage</A>
  1216. .
  1217. <p></dd>
  1218. <dt><B>Not a subroutine reference in %OVERLOAD</B>
  1219. <dd>
  1220. (F) An attempt was made to specify an entry in an overloading table that
  1221. doesn't somehow point to a valid subroutine.  See 
  1222. <A HREF="perlovl.html">
  1223. the perlovl manpage</A>
  1224. .
  1225. <p></dd>
  1226. <dt><B>Not an ARRAY reference</B>
  1227. <dd>
  1228. (F) Perl was trying to evaluate a reference to an array value, but
  1229. found a reference to something else instead.  You can use the ref()
  1230. function to find out what kind of ref it really was.  See 
  1231. <A HREF="perlref.html">
  1232. the perlref manpage</A>
  1233. .
  1234. <p></dd>
  1235. <dt><B>Not enough arguments for %s</B>
  1236. <dd>
  1237. (F) The function requires more arguments than you specified.
  1238. <p></dd>
  1239. <dt><B>Not enough format arguments</B>
  1240. <dd>
  1241. (W) A format specified more picture fields than the next line supplied.
  1242. See 
  1243. <A HREF="perlform.html">
  1244. the perlform manpage</A>
  1245. .
  1246. <p></dd>
  1247. <dt><B>Null filename used</B>
  1248. <dd>
  1249. (F) You can't require the null filename, especially since on many machines
  1250. that means the current directory!  See perlfunc/require.
  1251. <p></dd>
  1252. <dt><B>NULL OP IN RUN</B>
  1253. <dd>
  1254. (P) Some internal routine called run() with a null opcode pointer.
  1255. <p></dd>
  1256. <dt><B>Null realloc</B>
  1257. <dd>
  1258. (P) An attempt was made to realloc NULL.
  1259. <p></dd>
  1260. <dt><B>NULL regexp argument</B>
  1261. <dd>
  1262. (P) The internal pattern matching routines blew it bigtime.
  1263. <p></dd>
  1264. <dt><B>NULL regexp parameter</B>
  1265. <dd>
  1266. (P) The internal pattern matching routines are out of their gourd.
  1267. <p></dd>
  1268. <dt><B>Odd number of elements in hash list</B>
  1269. <dd>
  1270. (S) You specified an odd number of elements to a hash list, which is odd,
  1271. since hash lists come in key/value pairs.
  1272. <p></dd>
  1273. <dt><B>oops: oopsAV</B>
  1274. <dd>
  1275. (S) An internal warning that the grammar is screwed up.
  1276. <p></dd>
  1277. <dt><B>oops: oopsHV</B>
  1278. <dd>
  1279. (S) An internal warning that the grammar is screwed up.
  1280. <p></dd>
  1281. <dt><B>Operation `%s' %s: no method found,</B>
  1282. <dd>
  1283. (F) An attempt was made to use an entry in an overloading table that
  1284. somehow no longer points to a valid method.  See 
  1285. <A HREF="perlovl.html">
  1286. the perlovl manpage</A>
  1287. .
  1288. <p></dd>
  1289. <dt><B>Out of memory for yacc stack</B>
  1290. <dd>
  1291. (F) The yacc parser wanted to grow its stack so it could continue parsing,
  1292. but realloc() wouldn't give it more memory, virtual or otherwise.
  1293. <p></dd>
  1294. <dt><B>Out of memory!</B>
  1295. <dd>
  1296. (X) The malloc() function returned 0, indicating there was insufficient
  1297. remaining memory (or virtual memory) to satisfy the request.
  1298. <p></dd>
  1299. <dt><B>page overflow</B>
  1300. <dd>
  1301. (W) A single call to write() produced more lines than can fit on a page.
  1302. See 
  1303. <A HREF="perlform.html">
  1304. the perlform manpage</A>
  1305. .
  1306. <p></dd>
  1307. <dt><B>panic: ck_grep</B>
  1308. <dd>
  1309. (P) Failed an internal consistency check trying to compile a grep.
  1310. <p></dd>
  1311. <dt><B>panic: ck_split</B>
  1312. <dd>
  1313. (P) Failed an internal consistency check trying to compile a split.
  1314. <p></dd>
  1315. <dt><B>panic: corrupt saved stack index</B>
  1316. <dd>
  1317. (P) The savestack was requested to restore more localized values than there
  1318. are in the savestack.
  1319. <p></dd>
  1320. <dt><B>panic: die %s</B>
  1321. <dd>
  1322. (P) We popped the context stack to an eval context, and then discovered
  1323. it wasn't an eval context.
  1324. <p></dd>
  1325. <dt><B>panic: do_match</B>
  1326. <dd>
  1327. (P) The internal pp_match() routine was called with invalid operational data.
  1328. <p></dd>
  1329. <dt><B>panic: do_split</B>
  1330. <dd>
  1331. (P) Something terrible went wrong in setting up for the split.
  1332. <p></dd>
  1333. <dt><B>panic: do_subst</B>
  1334. <dd>
  1335. (P) The internal pp_subst() routine was called with invalid operational data.
  1336. <p></dd>
  1337. <dt><B>panic: do_trans</B>
  1338. <dd>
  1339. (P) The internal do_trans() routine was called with invalid operational data.
  1340. <p></dd>
  1341. <dt><B>panic: goto</B>
  1342. <dd>
  1343. (P) We popped the context stack to a context with the specified label,
  1344. and then discovered it wasn't a context we know how to do a goto in.
  1345. <p></dd>
  1346. <dt><B>panic: INTERPCASEMOD</B>
  1347. <dd>
  1348. (P) The lexer got into a bad state at a case modifier.
  1349. <p></dd>
  1350. <dt><B>panic: INTERPCONCAT</B>
  1351. <dd>
  1352. (P) The lexer got into a bad state parsing a string with brackets.
  1353. <p></dd>
  1354. <dt><B>panic: last</B>
  1355. <dd>
  1356. (P) We popped the context stack to a block context, and then discovered
  1357. it wasn't a block context.
  1358. <p></dd>
  1359. <dt><B>panic: leave_scope clearsv</B>
  1360. <dd>
  1361. (P) A writable lexical variable became readonly somehow within the scope.
  1362. <p></dd>
  1363. <dt><B>panic: leave_scope inconsistency</B>
  1364. <dd>
  1365. (P) The savestack probably got out of sync.  At least, there was an
  1366. invalid enum on the top of it.
  1367. <p></dd>
  1368. <dt><B>panic: malloc</B>
  1369. <dd>
  1370. (P) Something requested a negative number of bytes of malloc.
  1371. <p></dd>
  1372. <dt><B>panic: mapstart</B>
  1373. <dd>
  1374. (P) The compiler is screwed up with respect to the map() function.
  1375. <p></dd>
  1376. <dt><B>panic: null array</B>
  1377. <dd>
  1378. (P) One of the internal array routines was passed a null AV pointer.
  1379. <p></dd>
  1380. <dt><B>panic: pad_alloc</B>
  1381. <dd>
  1382. (P) The compiler got confused about which scratch pad it was allocating
  1383. and freeing temporaries and lexicals from.
  1384. <p></dd>
  1385. <dt><B>panic: pad_free curpad</B>
  1386. <dd>
  1387. (P) The compiler got confused about which scratch pad it was allocating
  1388. and freeing temporaries and lexicals from.
  1389. <p></dd>
  1390. <dt><B>panic: pad_free po</B>
  1391. <dd>
  1392. (P) An invalid scratch pad offset was detected internally.
  1393. <p></dd>
  1394. <dt><B>panic: pad_reset curpad</B>
  1395. <dd>
  1396. (P) The compiler got confused about which scratch pad it was allocating
  1397. and freeing temporaries and lexicals from.
  1398. <p></dd>
  1399. <dt><B>panic: pad_sv po</B>
  1400. <dd>
  1401. (P) An invalid scratch pad offset was detected internally.
  1402. <p></dd>
  1403. <dt><B>panic: pad_swipe curpad</B>
  1404. <dd>
  1405. (P) The compiler got confused about which scratch pad it was allocating
  1406. and freeing temporaries and lexicals from.
  1407. <p></dd>
  1408. <dt><B>panic: pad_swipe po</B>
  1409. <dd>
  1410. (P) An invalid scratch pad offset was detected internally.
  1411. <p></dd>
  1412. <dt><B>panic: pp_iter</B>
  1413. <dd>
  1414. (P) The foreach iterator got called in a non-loop context frame.
  1415. <p></dd>
  1416. <dt><B>panic: realloc</B>
  1417. <dd>
  1418. (P) Something requested a negative number of bytes of realloc.
  1419. <p></dd>
  1420. <dt><B>panic: restartop</B>
  1421. <dd>
  1422. (P) Some internal routine requested a goto (or something like it), and
  1423. didn't supply the destination.
  1424. <p></dd>
  1425. <dt><B>panic: return</B>
  1426. <dd>
  1427. (P) We popped the context stack to a subroutine or eval context, and
  1428. then discovered it wasn't a subroutine or eval context.
  1429. <p></dd>
  1430. <dt><B>panic: scan_num</B>
  1431. <dd>
  1432. (P) scan_num() got called on something that wasn't a number.
  1433. <p></dd>
  1434. <dt><B>panic: sv_insert</B>
  1435. <dd>
  1436. (P) The sv_insert() routine was told to remove more string than there
  1437. was string.
  1438. <p></dd>
  1439. <dt><B>panic: top_env</B>
  1440. <dd>
  1441. (P) The compiler attempted to do a goto, or something weird like that.
  1442. <p></dd>
  1443. <dt><B>panic: yylex</B>
  1444. <dd>
  1445. (P) The lexer got into a bad state while processing a case modifier.
  1446. <p></dd>
  1447. <dt><B>Parens missing around "%s" list</B>
  1448. <dd>
  1449. (W) You said something like
  1450. <p></dd>
  1451. <pre>
  1452.         my $foo, $bar = @_;
  1453. </pre>
  1454. when you meant
  1455. <p><pre>
  1456.         my ($foo, $bar) = @_;
  1457. </pre>
  1458. Remember that "my" and "local" bind closer than comma.
  1459. <p><dt><B>Perl %3.3f required--this is only version %s, stopped</B>
  1460. <dd>
  1461. (F) The module in question uses features of a version of Perl more recent
  1462. than the currently running version.  How long has it been since you upgraded,
  1463. anyway?  See perlfunc/require.
  1464. <p></dd>
  1465. <dt><B>Permission denied</B>
  1466. <dd>
  1467. (F) The setuid emulator in suidperl decided you were up to no good.
  1468. <p></dd>
  1469. <dt><B>POSIX getpgrp can't take an argument</B>
  1470. <dd>
  1471. (F) Your C compiler uses POSIX getpgrp(), which takes no argument, unlike
  1472. the BSD version, which takes a pid.
  1473. <p></dd>
  1474. <dt><B>Possible memory corruption: %s overflowed 3rd argument</B>
  1475. <dd>
  1476. (F) An ioctl() or fcntl() returned more than Perl was bargaining for.
  1477. Perl guesses a reasonable buffer size, but puts a sentinel byte at the
  1478. end of the buffer just in case.  This sentinel byte got clobbered, and
  1479. Perl assumes that memory is now corrupted.  See perlfunc/ioctl.
  1480. <p></dd>
  1481. <dt><B>Precedence problem: open %s should be open(%s)</B>
  1482. <dd>
  1483. (S) The old irregular construct
  1484.     
  1485.     open FOO || die;
  1486. <p></dd>
  1487. is now misinterpreted as
  1488. <p><pre>
  1489.         open(FOO || die);
  1490. </pre>
  1491. because of the strict regularization of Perl 5's grammar into unary and
  1492. list operators.  (The old open was a little of both.) You must put
  1493. parens around the filehandle, or use the new "or" operator instead of "||".
  1494. <p>
  1495. <dt><b><A NAME="perlfunc_189">print on closed filehandle %s</A></b>
  1496. <dd>
  1497. (W) The filehandle you're printing on got itself closed sometime before now.
  1498. Check your logic flow.
  1499. <p></dd>
  1500.  
  1501. <dt><b><A NAME="perlfunc_190">printf on closed filehandle %s</A></b>
  1502. <dd>
  1503. (W) The filehandle you're writing to got itself closed sometime before now.
  1504. Check your logic flow.
  1505. <p></dd>
  1506. <dt><B>Probable precedence problem on %s</B>
  1507. <dd>
  1508. (W) The compiler found a bare word where it expected a conditional,
  1509. which often indicates that an || or && was parsed as part of the
  1510. last argument of the previous construct, for example:
  1511. <p></dd>
  1512. <pre>
  1513.         open FOO || die;
  1514. </pre>
  1515. <dt><B>Read on closed filehandle <%s></B>
  1516. <dd>
  1517. (W) The filehandle you're reading from got itself closed sometime before now.
  1518. Check your logic flow.
  1519. <p></dd>
  1520. <dt><B>Reallocation too large: %lx</B>
  1521. <dd>
  1522. (F) You can't allocate more than 64K on an MSDOS machine.
  1523. <p></dd>
  1524. <dt><B>Recompile perl with  <A HREF="perlrun.html#perlrun_347">-D</A> DEBUGGING to use  <A HREF="perlrun.html#perlrun_347">-D</A>  switch</B>
  1525. <dd>
  1526. (F) You can't use the 
  1527. <A HREF="perlrun.html#perlrun_347">-D</A>
  1528.  option unless the code to produce the
  1529. desired output is compiled into Perl, which entails some overhead,
  1530. which is why it's currently left out of your copy.
  1531. <p></dd>
  1532. <dt><B>Recursive inheritance detected</B>
  1533. <dd>
  1534. (F) More than 100 levels of inheritance were used.  Probably indicates
  1535. an unintended loop in your inheritance hierarchy.
  1536. <p></dd>
  1537. <dt><B>Reference miscount in sv_replace()</B>
  1538. <dd>
  1539. (W) The internal sv_replace() function was handed a new SV with a
  1540. reference count of other than 1.
  1541. <p></dd>
  1542. <dt><B>regexp memory corruption</B>
  1543. <dd>
  1544. (P) The regular expression engine got confused by what the regular
  1545. expression compiler gave it.
  1546. <p></dd>
  1547. <dt><B>regexp out of space</B>
  1548. <dd>
  1549. (P) A "can't happen" error, because safemalloc() should have caught it earlier.
  1550. <p></dd>
  1551. <dt><B>regexp too big</B>
  1552. <dd>
  1553. (F) The current implementation of regular expression uses shorts as
  1554. address offsets within a string.  Unfortunately this means that if
  1555. the regular expression compiles to longer than 32767, it'll blow up.
  1556. Usually when you want a regular expression this big, there is a better
  1557. way to do it with multiple statements.  See 
  1558. <A HREF="perlre.html">
  1559. the perlre manpage</A>
  1560. .
  1561. <p></dd>
  1562. <dt><B>Reversed %s= operator</B>
  1563. <dd>
  1564. (W) You wrote your assignment operator backwards.  The = must always
  1565. comes last, to avoid ambiguity with subsequent unary operators.
  1566. <p></dd>
  1567. <dt><B>Runaway format</B>
  1568. <dd>
  1569. (F) Your format contained the ~~ repeat-until-blank sequence, but it
  1570. produced 200 lines at once, and the 200th line looked exactly like the
  1571. 199th line.  Apparently you didn't arrange for the arguments to exhaust
  1572. themselves, either by using ^ instead of @ (for scalar variables), or by
  1573. shifting or popping (for array variables).  See 
  1574. <A HREF="perlform.html">
  1575. the perlform manpage</A>
  1576. .
  1577. <p></dd>
  1578. <dt><B>Scalar value @%s[%s] better written as $%s[%s]</B>
  1579. <dd>
  1580. (W) You've used an array slice (indicated by @) to select a single value of
  1581. an array.  Generally it's better to ask for a scalar value (indicated by $).
  1582. The difference is that $foo[&bar] always behaves like a scalar, both when
  1583. assigning to it and when evaluating its argument, while @foo[&bar] behaves
  1584. like a list when you assign to it, and provides a list context to its
  1585. subscript, which can do weird things if you're only expecting one subscript.
  1586. <p></dd>
  1587. <dt><B>Script is not setuid/setgid in suidperl</B>
  1588. <dd>
  1589. (F) Oddly, the suidperl program was invoked on a script with its setuid
  1590. or setgid bit set.  This doesn't make much sense.
  1591. <p></dd>
  1592. <dt><B>Search pattern not terminated</B>
  1593. <dd>
  1594. (F) The lexer couldn't find the final delimiter of a // or m{}
  1595. construct.  Remember that bracketing delimiters count nesting level.
  1596. <p></dd>
  1597. <dt><B>seek() on unopened file</B>
  1598. <dd>
  1599. (W) You tried to use the seek() function on a filehandle that was either
  1600. never opened or has been closed since.
  1601. <p></dd>
  1602.  
  1603. <dt><b><A NAME="perlfunc_216">select not implemented</A></b>
  1604. <dd>
  1605. (F) This machine doesn't implement the select() system call.
  1606. <p></dd>
  1607. <dt><B>sem%s not implemented</B>
  1608. <dd>
  1609. (F) You don't have System V semaphore IPC on your system.
  1610. <p></dd>
  1611. <dt><B>semi-panic: attempt to dup freed string</B>
  1612. <dd>
  1613. (S) The internal newSVsv() routine was called to duplicate a scalar
  1614. that had previously been marked as free.
  1615. <p></dd>
  1616. <dt><B>Semicolon seems to be missing</B>
  1617. <dd>
  1618. (W) A nearby syntax error was probably caused by a missing semicolon,
  1619. or possibly some other missing operator, such as a comma.
  1620. <p></dd>
  1621. <dt><B>Send on closed socket</B>
  1622. <dd>
  1623. (W) The filehandle you're sending to got itself closed sometime before now.
  1624. Check your logic flow.
  1625. <p></dd>
  1626. <dt><B>Sequence (?#... not terminated</B>
  1627. <dd>
  1628. (F) A regular expression comment must be terminated by a closing
  1629. parenthesis.  Embedded parens aren't allowed.  See 
  1630. <A HREF="perlre.html">
  1631. the perlre manpage</A>
  1632. .
  1633. <p></dd>
  1634. <dt><B>Sequence (?%s...) not implemented</B>
  1635. <dd>
  1636. (F) A proposed regular expression extension has the character reserved
  1637. but has not yet been written.  See 
  1638. <A HREF="perlre.html">
  1639. the perlre manpage</A>
  1640. .
  1641. <p></dd>
  1642. <dt><B>Sequence (?%s...) not recognized</B>
  1643. <dd>
  1644. (F) You used a regular expression extension that doesn't make sense.
  1645. See 
  1646. <A HREF="perlre.html">
  1647. the perlre manpage</A>
  1648. .
  1649. <p></dd>
  1650. <dt><B>setegid() not implemented</B>
  1651. <dd>
  1652. (F) You tried to assign to $), and your operating system doesn't support
  1653. the setegid() system call (or equivalent), or at least Configure didn't
  1654. think so.
  1655. <p></dd>
  1656. <dt><B>seteuid() not implemented</B>
  1657. <dd>
  1658. (F) You tried to assign to $>, and your operating system doesn't support
  1659. the seteuid() system call (or equivalent), or at least Configure didn't
  1660. think so.
  1661. <p></dd>
  1662. <dt><B>setrgid() not implemented</B>
  1663. <dd>
  1664. (F) You tried to assign to $(, and your operating system doesn't support
  1665. the setrgid() system call (or equivalent), or at least Configure didn't
  1666. think so.
  1667. <p></dd>
  1668. <dt><B>setruid() not implemented</B>
  1669. <dd>
  1670. (F) You tried to assign to $<, and your operating system doesn't support
  1671. the setruid() system call (or equivalent), or at least Configure didn't
  1672. think so.
  1673. <p></dd>
  1674. <dt><B>Setuid/gid script is writable by world</B>
  1675. <dd>
  1676. (F) The setuid emulator won't run a script that is writable by the world,
  1677. because the world might have written on it already.
  1678. <p></dd>
  1679. <dt><B>shm%s not implemented</B>
  1680. <dd>
  1681. (F) You don't have System V shared memory IPC on your system.
  1682. <p></dd>
  1683. <dt><B>shutdown() on closed fd</B>
  1684. <dd>
  1685. (W) You tried to do a shutdown on a closed socket.  Seems a bit superfluous.
  1686. <p></dd>
  1687. <dt><B>SIG%s handler "%s" not defined.</B>
  1688. <dd>
  1689. (W) The signal handler named in %SIG doesn't, in fact, exist.  Perhaps you
  1690. put it into the wrong package?
  1691. <p></dd>
  1692.  
  1693. <dt><b><A NAME="perlfunc_234">sort is now a reserved word</A></b>
  1694. <dd>
  1695. (F) An ancient error message that almost nobody ever runs into anymore.
  1696. But before sort was a keyword, people sometimes used it as a filehandle.
  1697. <p></dd>
  1698. <dt><B>Sort subroutine didn't return a numeric value</B>
  1699. <dd>
  1700. (F) A sort comparison routine must return a number.  You probably blew
  1701. it by not using C<<=> or <B>cmp</B>, or by not using them correctly.
  1702. See perlfunc/sort.
  1703. <p></dd>
  1704. <dt><B>Sort subroutine didn't return single value</B>
  1705. <dd>
  1706. (F) A sort comparison subroutine may not return a list value with more
  1707. or less than one element.  See perlfunc/sort.
  1708. <p></dd>
  1709. <dt><B>Split loop</B>
  1710. <dd>
  1711. (P) The split was looping infinitely.  (Obviously, a split shouldn't iterate
  1712. more times than there are characters of input, which is what happened.)
  1713. See perlfunc/split.
  1714. <p></dd>
  1715. <dt><B>Stat on unopened file <%s></B>
  1716. <dd>
  1717. (W) You tried to use the stat() function (or an equivalent file test)
  1718. on a filehandle that was either never opened or has been closed since.
  1719. <p></dd>
  1720. <dt><B>Statement unlikely to be reached</B>
  1721. <dd>
  1722. (W) You did an exec() with some statement after it other than a die().
  1723. This is almost always an error, because exec() never returns unless
  1724. there was a failure.  You probably wanted to use system() instead,
  1725. which does return.  To suppress this warning, put the exec() in a block
  1726. by itself.
  1727. <p></dd>
  1728. <dt><B>Subroutine %s redefined</B>
  1729. <dd>
  1730. (W) You redefined a subroutine.  To suppress this warning, say
  1731. <p></dd>
  1732. <pre>
  1733.         {
  1734.         local $^W = 0;
  1735.         eval "sub name { ... }";
  1736.         }
  1737. </pre>
  1738. <dt><B>Substitution loop</B>
  1739. <dd>
  1740. (P) The substitution was looping infinitely.  (Obviously, a
  1741. substitution shouldn't iterate more times than there are characters of
  1742. input, which is what happened.) See the discussion of substitution in
  1743. perlop/"Quote and Quotelike Operators".
  1744. <p></dd>
  1745. <dt><B>Substitution pattern not terminated</B>
  1746. <dd>
  1747. (F) The lexer couldn't find the interior delimiter of a s/// or s{}{}
  1748. construct.  Remember that bracketing delimiters count nesting level.
  1749. <p></dd>
  1750. <dt><B>Substitution replacement not terminated</B>
  1751. <dd>
  1752. (F) The lexer couldn't find the final delimiter of a s/// or s{}{}
  1753. construct.  Remember that bracketing delimiters count nesting level.
  1754. <p></dd>
  1755.  
  1756. <dt><b><A NAME="perlfunc_242">substr outside of string</A></b>
  1757. <dd>
  1758. (W) You tried to reference a substr() that pointed outside of a string.
  1759. That is, the absolute value of the offset was larger than the length of
  1760. the string.  See perlfunc/substr.
  1761. <p></dd>
  1762. <dt><B>suidperl is no longer needed since...</B>
  1763. <dd>
  1764. (F) Your Perl was compiled with 
  1765. <A HREF="perlrun.html#perlrun_347">-D</A>
  1766. SETUID_SCRIPTS_ARE_SECURE_NOW, but a
  1767. version of the setuid emulator somehow got run anyway.
  1768. <p></dd>
  1769. <dt><B>syntax error</B>
  1770. <dd>
  1771. (F) Probably means you had a syntax error.  Common reasons include:
  1772. <p></dd>
  1773. <pre>
  1774.         A keyword is misspelled.
  1775.         A semicolon is missing.
  1776.         A comma is missing.
  1777.         An opening or closing parenthesis is missing.
  1778.         An opening or closing brace is missing.
  1779.         A closing quote is missing.
  1780. </pre>
  1781. Often there will be another error message associated with the syntax
  1782. error giving more information.  (Sometimes it helps to turn on 
  1783. <A HREF="perlrun.html#perlrun_362">-w</A>
  1784. .)
  1785. The error message itself often tells you where it was in the line when
  1786. it decided to give up.  Sometimes the actual error is several tokens
  1787. before this, since Perl is good at understanding random input.
  1788. Occasionally the line number may be misleading, and once in a blue moon
  1789. the only way to figure out what's triggering the error is to call
  1790. <B>perl -c</B> repeatedly, chopping away half the program each time to see
  1791. if the error went away.  Sort of the cybernetic version of 20 questions.
  1792. <p><dt><B>System V IPC is not implemented on this machine</B>
  1793. <dd>
  1794. (F) You tried to do something with a function beginning with "sem", "shm"
  1795. or "msg".  See perlfunc/semctl, for example.
  1796. <p></dd>
  1797. <dt><B>Syswrite on closed filehandle</B>
  1798. <dd>
  1799. (W) The filehandle you're writing to got itself closed sometime before now.
  1800. Check your logic flow.
  1801. <p></dd>
  1802. <dt><B>tell() on unopened file</B>
  1803. <dd>
  1804. (W) You tried to use the tell() function on a filehandle that was either
  1805. never opened or has been closed since.
  1806. <p></dd>
  1807. <dt><B>Test on unopened file <%s></B>
  1808. <dd>
  1809. (W) You tried to invoke a file test operator on a filehandle that isn't
  1810. open.  Check your logic.  See also perlfunc/-X.
  1811. <p></dd>
  1812. <dt><B>That use of $[ is unsupported</B>
  1813. <dd>
  1814. (F) Assignment to $[ is now strictly circumscribed, and interpreted as
  1815. a compiler directive.  You may only say one of
  1816. <p></dd>
  1817. <pre>
  1818.         $[ = 0;
  1819.         $[ = 1;
  1820.         ...
  1821.         local $[ = 0;
  1822.         local $[ = 1;
  1823.         ...
  1824. </pre>
  1825. This is to prevent the problem of one module changing the array base
  1826. out from under another module inadvertently.  See perlvar/$[.
  1827. <p><dt><B>The %s function is unimplemented</B>
  1828. <dd>
  1829. The function indicated isn't implemented on this architecture, according
  1830. to the probings of Configure.
  1831. <p></dd>
  1832. <dt><B>The crypt() function is unimplemented due to excessive paranoia.</B>
  1833. <dd>
  1834. (F) Configure couldn't find the crypt() function on your machine,
  1835. probably because your vendor didn't supply it, probably because they
  1836. think the U.S. Govermnment thinks it's a secret, or at least that they
  1837. will continue to pretend that it is.  And if you quote me on that, I
  1838. will deny it.
  1839. <p></dd>
  1840. <dt><B>The stat preceding <B>-l _</B> wasn't an lstat</B>
  1841. <dd>
  1842. (F) It makes no sense to test the current stat buffer for symbolic linkhood
  1843. if the last stat that wrote to the stat buffer already went past
  1844. the symlink to get to the real file.  Use an actual filename instead.
  1845. <p></dd>
  1846.  
  1847. <dt><b><A NAME="perlfunc_252">times not implemented</A></b>
  1848. <dd>
  1849. (F) Your version of the C library apparently doesn't do times().  I suspect
  1850. you're not running on Unix.
  1851. <p></dd>
  1852. <dt><B>Too few args to syscall</B>
  1853. <dd>
  1854. (F) There has to be at least one argument to syscall() to specify the
  1855. system call to call, silly dilly.
  1856. <p></dd>
  1857. <dt><B>Too many args to syscall</B>
  1858. <dd>
  1859. (F) Perl only supports a maximum of 14 args to syscall().
  1860. <p></dd>
  1861. <dt><B>Too many arguments for %s</B>
  1862. <dd>
  1863. (F) The function requires fewer arguments than you specified.
  1864. <p></dd>
  1865. <dt><B>trailing \ in regexp</B>
  1866. <dd>
  1867. (F) The regular expression ends with an unbackslashed backslash.  Backslash
  1868. it.   See 
  1869. <A HREF="perlre.html">
  1870. the perlre manpage</A>
  1871. .
  1872. <p></dd>
  1873. <dt><B>Translation pattern not terminated</B>
  1874. <dd>
  1875. (F) The lexer couldn't find the interior delimiter of a tr/// or tr[][]
  1876. construct.
  1877. <p></dd>
  1878. <dt><B>Translation replacement not terminated</B>
  1879. <dd>
  1880. (F) The lexer couldn't find the final delimiter of a tr/// or tr[][]
  1881. construct.
  1882. <p></dd>
  1883.  
  1884. <dt><b><A NAME="perlfunc_254">truncate not implemented</A></b>
  1885. <dd>
  1886. (F) Your machine doesn't implement a file truncation mechanism that
  1887. Configure knows about.
  1888. <p></dd>
  1889. <dt><B>Type of arg %d to %s must be %s (not %s)</B>
  1890. <dd>
  1891. (F) This function requires the argument in that position to be of a
  1892. certain type.  Arrays must be @NAME or @{EXPR}.  Hashes must be
  1893. %NAME or %{EXPR}.  No implicit dereferencing is allowed--use the
  1894. {EXPR} forms as an explicit dereference.  See 
  1895. <A HREF="perlref.html">
  1896. the perlref manpage</A>
  1897. .
  1898. <p></dd>
  1899. <dt><B>umask: argument is missing initial 0</B>
  1900. <dd>
  1901. (W) A umask of 222 is incorrect.  It should be 0222, since octal literals
  1902. always start with 0 in Perl, as in C.
  1903. <p></dd>
  1904. <dt><B>Unbalanced context: %d more PUSHes than POPs</B>
  1905. <dd>
  1906. (W) The exit code detected an internal inconsistency in how many execution
  1907. contexts were entered and left.
  1908. <p></dd>
  1909. <dt><B>Unbalanced saves: %d more saves than restores</B>
  1910. <dd>
  1911. (W) The exit code detected an internal inconsistency in how many
  1912. values were temporarily localized.
  1913. <p></dd>
  1914. <dt><B>Unbalanced scopes: %d more ENTERs than LEAVEs</B>
  1915. <dd>
  1916. (W) The exit code detected an internal inconsistency in how many blocks
  1917. were entered and left.
  1918. <p></dd>
  1919. <dt><B>Unbalanced tmps: %d more allocs than frees</B>
  1920. <dd>
  1921. (W) The exit code detected an internal inconsistency in how many mortal
  1922. scalars were allocated and freed.
  1923. <p></dd>
  1924. <dt><B>Undefined format "%s" called</B>
  1925. <dd>
  1926. (F) The format indicated doesn't seem to exist.  Perhaps it's really in
  1927. another package?  See 
  1928. <A HREF="perlform.html">
  1929. the perlform manpage</A>
  1930. .
  1931. <p></dd>
  1932. <dt><B>Undefined sort subroutine "%s" called</B>
  1933. <dd>
  1934. (F) The sort comparison routine specified doesn't seem to exist.  Perhaps
  1935. it's in a different package?  See perlfunc/sort.
  1936. <p></dd>
  1937. <dt><B>Undefined subroutine &%s called</B>
  1938. <dd>
  1939. (F) The subroutine indicated hasn't been defined, or if it was, it
  1940. has since been undefined.
  1941. <p></dd>
  1942. <dt><B>Undefined subroutine called</B>
  1943. <dd>
  1944. (F) The anonymous subroutine you're trying to call hasn't been defined,
  1945. or if it was, it has since been undefined.
  1946. <p></dd>
  1947. <dt><B>Undefined subroutine in sort</B>
  1948. <dd>
  1949. (F) The sort comparison routine specified is declared but doesn't seem to
  1950. have been defined yet.  See perlfunc/sort.
  1951. <p></dd>
  1952. <dt><B>unexec of %s into %s failed!</B>
  1953. <dd>
  1954. (F) The unexec() routine failed for some reason.  See your local FSF
  1955. representative, who probably put it there in the first place.
  1956. <p></dd>
  1957. <dt><B>Unknown BYTEORDER</B>
  1958. <dd>
  1959. (F) There are no byteswapping functions for a machine with this byte order.
  1960. <p></dd>
  1961. <dt><B>unmatched () in regexp</B>
  1962. <dd>
  1963. (F) Unbackslashed parentheses must always be balanced in regular
  1964. expressions.  If you're a vi user, the % key is valuable for finding
  1965. the matching paren.  See 
  1966. <A HREF="perlre.html">
  1967. the perlre manpage</A>
  1968. .
  1969. <p></dd>
  1970. <dt><B>Unmatched right bracket</B>
  1971. <dd>
  1972. (F) The lexer counted more closing curly brackets (braces) than opening
  1973. ones, so you're probably missing an opening bracket.  As a general
  1974. rule, you'll find the missing one (so to speak) near the place you were
  1975. last editing.
  1976. <p></dd>
  1977. <dt><B>unmatched [] in regexp</B>
  1978. <dd>
  1979. (F) The brackets around a character class must match.  If you wish to
  1980. include a closing bracket in a character class, backslash it or put it first.
  1981. See 
  1982. <A HREF="perlre.html">
  1983. the perlre manpage</A>
  1984. .
  1985. <p></dd>
  1986. <dt><B>Unquoted string "%s" may clash with future reserved word</B>
  1987. <dd>
  1988. (W) You used a bare word that might someday be claimed as a reserved word.
  1989. It's best to put such a word in quotes, or capitalize it somehow, or insert
  1990. an underbar into it.  You might also declare it as a subroutine.
  1991. <p></dd>
  1992. <dt><B>Unrecognized character \%03o ignored</B>
  1993. <dd>
  1994. (S) A garbage character was found in the input, and ignored, in case it's
  1995. a weird control character on an EBCDIC machine, or some such.
  1996. <p></dd>
  1997. <dt><B>Unrecognized signal name "%s"</B>
  1998. <dd>
  1999. (F) You specified a signal name to the kill() function that was not recognized.
  2000. Say <B>kill -l</B> in your shell to see the valid signal names on your system.
  2001. <p></dd>
  2002. <dt><B>Unrecognized switch: -%s</B>
  2003. <dd>
  2004. (F) You specified an illegal option to Perl.  Don't do that.
  2005. (If you think you didn't do that, check the #! line to see if it's
  2006. supplying the bad switch on your behalf.)
  2007. <p></dd>
  2008. <dt><B>Unsuccessful %s on filename containing newline</B>
  2009. <dd>
  2010. (W) A file operation was attempted on a filename, and that operation
  2011. failed, PROBABLY because the filename contained a newline, PROBABLY
  2012. because you forgot to chop() or chomp() it off.  See perlfunc/chop.
  2013. <p></dd>
  2014. <dt><B>Unsupported directory function "%s" called</B>
  2015. <dd>
  2016. (F) Your machine doesn't support opendir() and readdir().
  2017. <p></dd>
  2018. <dt><B>Unsupported function %s</B>
  2019. <dd>
  2020. (F) This machines doesn't implement the indicated function, apparently.
  2021. At least, Configure doesn't think so.
  2022. <p></dd>
  2023. <dt><B>Unsupported socket function "%s" called</B>
  2024. <dd>
  2025. (F) Your machine doesn't support the Berkeley socket mechanism, or at
  2026. least that's what Configure thought.
  2027. <p></dd>
  2028. <dt><B>Unterminated <> operator</B>
  2029. <dd>
  2030. (F) The lexer saw a left angle bracket in a place where it was expecting
  2031. a term, so it's looking for the corresponding right angle bracket, and not
  2032. finding it.  Chances are you left some needed parentheses out earlier in
  2033. the line, and you really meant a "less than".
  2034. <p></dd>
  2035. <dt><B>Use of $# is deprecated</B>
  2036. <dd>
  2037. (D) This was an ill-advised attempt to emulate a poorly defined awk feature.
  2038. Use an explicit printf() or sprintf() instead.
  2039. <p></dd>
  2040. <dt><B>Use of $* is deprecated</B>
  2041. <dd>
  2042. (D) This variable magically turned on multiline pattern matching, both for
  2043. you and for any luckless subroutine that you happen to call.  You should
  2044. use the new <B>//m</B> and <B>//s</B> modifiers now to do that without the dangerous
  2045. action-at-a-distance effects of 
  2046. <A HREF="perlvar.html#perlvar_382">$*</A>
  2047. .
  2048. <p></dd>
  2049. <dt><B>Use of %s is deprecated</B>
  2050. <dd>
  2051. (D) The construct indicated is no longer recommended for use, generally
  2052. because there's a better way to do it, and also because the old way has
  2053. bad side effects.
  2054. <p></dd>
  2055. <dt><B>Use of implicit split to @_ is deprecated</B>
  2056. <dd>
  2057. (D) It makes a lot of work for the compiler when you clobber a
  2058. subroutine's argument list, so it's better if you assign the results of
  2059. a split() explicitly to an array (or list).
  2060. <p></dd>
  2061. <dt><B>Use of uninitialized value</B>
  2062. <dd>
  2063. (W) An undefined value was used as if it were already defined.  It was
  2064. interpreted as a "" or a 0, but maybe it was a mistake.  To suppress this
  2065. warning assign an initial value to your variables.
  2066. <p></dd>
  2067. <dt><B>Useless use of %s in void context</B>
  2068. <dd>
  2069. (W) You did something without a side effect in a context that does nothing
  2070. with the return value, such as a statement that doesn't return a value
  2071. from a block, or the left side of a scalar comma operator.  Very often
  2072. this points not to stupidity on your part, but a failure of Perl to parse
  2073. your program the way you thought it would.  For example, you'd get this
  2074. if you mixed up your C precedence with Python precedence and said
  2075. <p></dd>
  2076. <pre>
  2077.         $one, $two = 1, 2;
  2078. </pre>
  2079. when you meant to say
  2080. <p><pre>
  2081.         ($one, $two) = (1, 2);
  2082. </pre>
  2083. <dt><B>Warning: unable to close filehandle %s properly.</B>
  2084. <dd>
  2085. (S) The implicit close() done by an open() got an error indication on the 
  2086. close(0.  This usually indicates your filesystem ran out of disk space.
  2087. <p></dd>
  2088. <dt><B>Warning: Use of "%s" without parens is ambiguous</B>
  2089. <dd>
  2090. (S) You wrote a unary operator followed by something that looks like a
  2091. binary operator that could also have been interpreted as a term or
  2092. unary operator.  For instance, if you know that the rand function
  2093. has a default argument of 1.0, and you write
  2094. <p></dd>
  2095. <pre>
  2096.         rand + 5;
  2097. </pre>
  2098. you may THINK you wrote the same thing as
  2099. <p><pre>
  2100.         rand() + 5;
  2101. </pre>
  2102. but in actual fact, you got
  2103. <p><pre>
  2104.         rand(+5);
  2105. </pre>
  2106. So put in parens to say what you really mean.
  2107. <p><dt><B>Write on closed filehandle</B>
  2108. <dd>
  2109. (W) The filehandle you're writing to got itself closed sometime before now.
  2110. Check your logic flow.
  2111. <p></dd>
  2112. <dt><B>X outside of string</B>
  2113. <dd>
  2114. (F) You had a pack template that specified a relative position before
  2115. the beginning of the string being unpacked.  See perlfunc/pack.
  2116. <p></dd>
  2117. <dt><B>x outside of string</B>
  2118. <dd>
  2119. (F) You had a pack template that specified a relative position after
  2120. the end of the string being unpacked.  See perlfunc/pack.
  2121. <p></dd>
  2122. <dt><B>Xsub "%s" called in sort</B>
  2123. <dd>
  2124. (F) The use of an external subroutine as a sort comparison is not yet supported.
  2125. <p></dd>
  2126. <dt><B>Xsub called in sort</B>
  2127. <dd>
  2128. (F) The use of an external subroutine as a sort comparison is not yet supported.
  2129. <p></dd>
  2130. <dt><B>You can't use  <A HREF="perlrun.html#perlrun_352">-l</A>  on a filehandle</B>
  2131. <dd>
  2132. (F) A filehandle represents an opened file, and when you opened the file it
  2133. already went past any symlink you are presumably trying to look for.
  2134. Use a filename instead.
  2135. <p></dd>
  2136. <dt><B>YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!</B>
  2137. <dd>
  2138. (F) And you probably never will, since you probably don't have the
  2139. sources to your kernel, and your vendor probably doesn't give a rip
  2140. about what you want.  Your best bet is to use the wrapsuid script in
  2141. the eg directory to put a setuid C wrapper around your script.
  2142. <p></dd>
  2143. <dt><B>You need to quote "%s"</B>
  2144. <dd>
  2145. (W) You assigned a bareword as a signal handler name.  Unfortunately, you
  2146. already have a subroutine of that name declared, which means that Perl 5
  2147. will try to call the subroutine when the assignment is executed, which is
  2148. probably not what you want.  (If it IS what you want, put an & in front.)
  2149. <p></dd>
  2150. <dt><B>[gs]etsockopt() on closed fd</B>
  2151. <dd>
  2152. (W) You tried to get or set a socket option on a closed socket.
  2153. Did you forget to check the return value of your socket() call?
  2154. See perlfunc/getsockopt.
  2155. <p></dd>
  2156. <dt><B>\1 better written as $1</B>
  2157. <dd>
  2158. (W) Outside of patterns, backreferences live on as variables.  The use
  2159. of backslashes is grandfathered on the righthand side of a
  2160. substitution, but stylistically it's better to use the variable form
  2161. because other Perl programmers will expect it, and it works better
  2162. if there are more than 9 backreferences.
  2163. <p></dd>
  2164.  
  2165. </dl>
  2166.  
  2167.